usci_a_spi.h

Go to the documentation of this file.

//*****************************************************************************
//
// usci_a_spi.h - Driver for the USCI_A_SPI Module.
//
//*****************************************************************************
 
#ifndef __MSP430WARE_USCI_A_SPI_H__
#define __MSP430WARE_USCI_A_SPI_H__
 
#include "inc/hw_memmap.h"
 
#ifdef __MSP430_HAS_USCI_Ax__
 
//*****************************************************************************
//
// If building with a C++ compiler, make all of the definitions in this header
// have a C binding.
//
//*****************************************************************************
#ifdef __cplusplus
extern "C"
{
#endif
 
#include "inc/hw_memmap.h"
//*****************************************************************************
//
//
//*****************************************************************************
typedef struct USCI_A_SPI_initMasterParam {
    uint8_t selectClockSource;
    uint32_t clockSourceFrequency;
    uint32_t desiredSpiClock;
    uint8_t msbFirst;
    uint8_t clockPhase;
    uint8_t clockPolarity;
} USCI_A_SPI_initMasterParam;
 
//*****************************************************************************
//
//
//*****************************************************************************
typedef struct USCI_A_SPI_changeMasterClockParam {
    uint32_t clockSourceFrequency;
    uint32_t desiredSpiClock;
} USCI_A_SPI_changeMasterClockParam;
 
 
//*****************************************************************************
//
// The following are values that can be passed to the clockPhase parameter for
// functions: USCI_A_SPI_initSlave(), and
// USCI_A_SPI_changeClockPhasePolarity(); the param parameter for functions:
// USCI_A_SPI_initMaster().
//
//*****************************************************************************
#define USCI_A_SPI_PHASE_DATA_CHANGED_ONFIRST_CAPTURED_ON_NEXT             0x00
#define USCI_A_SPI_PHASE_DATA_CAPTURED_ONFIRST_CHANGED_ON_NEXT           UCCKPH
 
//*****************************************************************************
//
// The following are values that can be passed to the msbFirst parameter for
// functions: USCI_A_SPI_initSlave(); the param parameter for functions:
// USCI_A_SPI_initMaster().
//
//*****************************************************************************
#define USCI_A_SPI_MSB_FIRST                                              UCMSB
#define USCI_A_SPI_LSB_FIRST                                               0x00
 
//*****************************************************************************
//
// The following are values that can be passed to the param parameter for
// functions: USCI_A_SPI_initMaster(); the clockPolarity parameter for
// functions: USCI_A_SPI_initSlave(), and
// USCI_A_SPI_changeClockPhasePolarity().
//
//*****************************************************************************
#define USCI_A_SPI_CLOCKPOLARITY_INACTIVITY_HIGH                         UCCKPL
#define USCI_A_SPI_CLOCKPOLARITY_INACTIVITY_LOW                            0x00
 
//*****************************************************************************
//
// The following are values that can be passed to the param parameter for
// functions: USCI_A_SPI_initMaster().
//
//*****************************************************************************
#define USCI_A_SPI_CLOCKSOURCE_ACLK                                UCSSEL__ACLK
#define USCI_A_SPI_CLOCKSOURCE_SMCLK                              UCSSEL__SMCLK
 
//*****************************************************************************
//
// The following are values that can be passed to the mask parameter for
// functions: USCI_A_SPI_enableInterrupt(), USCI_A_SPI_disableInterrupt(),
// USCI_A_SPI_getInterruptStatus(), and USCI_A_SPI_clearInterrupt() as well as
// returned by the USCI_A_SPI_getInterruptStatus() function.
//
//*****************************************************************************
#define USCI_A_SPI_TRANSMIT_INTERRUPT                                    UCTXIE
#define USCI_A_SPI_RECEIVE_INTERRUPT                                     UCRXIE
 
//*****************************************************************************
//
// The following are values that can be passed toThe following are values that
// can be returned by the USCI_A_SPI_isBusy() function.
//
//*****************************************************************************
#define USCI_A_SPI_BUSY                                                  UCBUSY
#define USCI_A_SPI_NOT_BUSY                                                0x00
 
//*****************************************************************************
//
// Prototypes for the APIs.
//
//*****************************************************************************
 
//*****************************************************************************
//
//
//*****************************************************************************
extern bool USCI_A_SPI_initMaster(uint16_t baseAddress,
                                  USCI_A_SPI_initMasterParam *param);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern void USCI_A_SPI_changeMasterClock(uint16_t baseAddress,
                                         USCI_A_SPI_changeMasterClockParam *param);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern bool USCI_A_SPI_initSlave(uint16_t baseAddress,
                                 uint8_t msbFirst,
                                 uint8_t clockPhase,
                                 uint8_t clockPolarity);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern void USCI_A_SPI_changeClockPhasePolarity(uint16_t baseAddress,
                                                uint8_t clockPhase,
                                                uint8_t clockPolarity);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern void USCI_A_SPI_transmitData(uint16_t baseAddress,
                                    uint8_t transmitData);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern uint8_t USCI_A_SPI_receiveData(uint16_t baseAddress);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern void USCI_A_SPI_enableInterrupt(uint16_t baseAddress,
                                       uint8_t mask);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern void USCI_A_SPI_disableInterrupt(uint16_t baseAddress,
                                        uint8_t mask);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern uint8_t USCI_A_SPI_getInterruptStatus(uint16_t baseAddress,
                                             uint8_t mask);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern void USCI_A_SPI_clearInterrupt(uint16_t baseAddress,
                                      uint8_t mask);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern void USCI_A_SPI_enable(uint16_t baseAddress);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern void USCI_A_SPI_disable(uint16_t baseAddress);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern uint32_t USCI_A_SPI_getReceiveBufferAddressForDMA(uint16_t baseAddress);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern uint32_t USCI_A_SPI_getTransmitBufferAddressForDMA(uint16_t baseAddress);
 
//*****************************************************************************
//
//
//*****************************************************************************
extern uint8_t USCI_A_SPI_isBusy(uint16_t baseAddress);
 
//*****************************************************************************
//
// Mark the end of the C bindings section for C++ compilers.
//
//*****************************************************************************
#ifdef __cplusplus
}
#endif
 
#endif
#endif // __MSP430WARE_USCI_A_SPI_H__